.TH E1432_SET_INPUT_MODE 3 E1432
.SH NAME
.nf
e1432_set_input_mode \- Set input mode to volt or ICP
e1432_get_input_mode \- Get current state of input mode
.fi
.IX e1432_set_input_mode(3) 3
.IX e1432_get_input_mode(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_input_mode(E1432ID hw, SHORTSIZ16 ID,
                                SHORTSIZ16 mode)
SHORTSIZ16 e1432_get_input_mode(E1432ID hw, SHORTSIZ16 ID,
                                SHORTSIZ16 *mode)
.cE
.SH DESCRIPTION
\fIe1432_set_input_mode\fR sets the input mode,
of a single channel or group of channels \fIID\fR,
to the value given in \fImode\fR.

\fIe1432_get_input_mode\fR returns the current value of the input
mode, of a single channel or group of channels \fIID\fR, into a memory
location pointed to by \fImode\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fImode\fR determines the input mode in the front end.
\fBE1432_INPUT_MODE_VOLT\fR sets the volt input mode.
\fBE1432_INPUT_MODE_ICP\fR sets the ICP input mode.
\fBE1432_INPUT_MODE_CHARGE\fR sets the input mode to charge-amp mode.
\fBE1432_INPUT_MODE_MIC\fR sets the input mode to microphone mode.
\fBE1432_INPUT_MODE_MIC_200V\fR sets the input mode to microphone mode
with 200V supply turned on.

This parameter may also be set with \fIe1432_set_analog_input\fR.

If there is not a smart break-out box connected to the channel, then
changing the input mode for one channel causes the input mode for all
channels within that SCA to change.  If there is a smart break-out box
present, then the input mode applies only to the specific channels
specified.

\fBE1432_INPUT_MODE_CHARGE\fR is valid only if a Charge break-out box
is attached to the channel specified.  In this mode, the full-scale
setting is controlled by the \fIe1432_set_range_charge\fR function,
which specifies the full scale in picoCoulombs.  In this mode, all
input data for this channel is in terms of picoCoulombs rather than
volts.  See \fIe1432_bob\fR for more information about break-out
boxes.

\fBE1432_INPUT_MODE_MIC\fR and \fBE1432_INPUT_MODE_MIC_200V\fR are
valid only if a Microphone break-out box is attached to the channel
specified.  In these two modes, the full-scale setting is controlled
by the \fIe1432_set_range_mike\fR function.  See \fIe1432_bob\fR for
more information about break-out boxes.

There is not actually an ICP current source inside the E1432/E1433
input SCAs.  Instead, a breakout box containing an ICP current source
can be attached to the input.  When this ICP breakout box is attached,
then setting the \fImode\fR to \fBE1432_INPUT_MODE_ICP\fR enables the
ICP current source in the breakout box.  If there is no ICP breakout
box attached to the input, then setting \fBE1432_INPUT_MODE_ICP\fR
does nothing.
.SH "RESET VALUE"
After a reset, \fImode\fR is set to \fBE1432_INPUT_MODE_VOLT\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_analog_input, e1432_set_range, e1432_set_range_charge,
e1432_set_range_mike, e1432_bob
.ad
